RLOG(1) | General Commands Manual | RLOG(1) |
名称¶
rlog - RCS ファイルのログメッセージや、その他の関連情報を表示する
書式¶
rlog [ options ] file ...
解説¶
rlog は RCS ファイルに関する情報を表示します。
RCS 拡張子にマッチするファイル名は RCS ファイルであるとみなし、 その他のファイル名はワークファイルであるとみなします。 ci(1)で説明しているように、ファイル名はRCSファイルと ワークファイルのペアになっています。
rlog は、各 RCS ファイルの以下の情報を表示します: RCS ファイルのパス名、 ワークファイルのパス名、ヘッド(幹で最新のリビジョン)、デフォルト枝、 アクセスリスト、ロック状況、シンボル名、拡張子、総リビジョン数、 指定されたリビジョンの数、内容記述。以上の情報に加え、新しいものから順に 選択されたリビジョンのリストが表示されます。各リビジョンに関して、 rlog は、 リビジョン番号、作者、日時、状態、(直前のリビジョンから)追加/削除された行数、 ロック者、ログメッセージを表示します。 デフォルトでは、表示されるすべての時刻は協定世界時 (UTC) です ; これは -z オプションで書き換え可能です。 オプションを指定しない場合、 rlog は以上のすべての情報を表示します。 以下のオプションにより表示する内容を限定することができます。
- -L
- ロックされていない RCS ファイルを無視します。 -h 、 -l 、 -R オプションと組み合わせると便利です。
- -R
- RCS ファイル名のみを表示します。ワークファイルのパス名を RCS ファイル 名に変換するのに便利です。
- -v[string]
- ワーキングファイルの名前とデフォルト枝(の枝)の先端リビジョンだけを表示します。 [string] で指定した文字列は出力行の先頭に出力されます。
- -h
- RCS ファイルのパス名、ワークファイルのパス名、ヘッド、デフォルト枝、ア クセスリスト、ロック者、シンボル名、拡張子を表示します。
- -t
- -h の情報に追加して内容記述を表示します。
- -N
- シンボル名を表示しません。
- -b
- デフォルト枝に関する情報を表示します。通常は、幹の最も大きな番号を持つ枝 です。
- -ddates
- セミコロンで区切られた、登録日時の範囲にあるリビジョンに関する情報を 表示します。 d1<d2 または d2>d1 なる形式の範囲は、日時 d1 から日時 d2 までの間 (d1とd2は除く) に登録されたリビジョンを指定します。 <d または d> なる形式の範囲は、日時 d より前に登録されたすべてのリビジョンを指定します。 d< または >d なる形式の範囲は日時 d より後を指定します。 もし < または > に = が続いていれば、範囲は両端を含むようになります。 d なる形式の範囲は日時 d 以前の最新のリビジョンを指定します。 d 、 d1 、 d2 は co(1) に記述されている自由形式の日時です。 通常 < や > を使う場合にはクォートが必要です。要素の区切りがセミコロンであることに 注意してください。
- -l[lockers]
- ロックされているリビジョンに関する情報のみを表示します。コンマで区切られた ユーザ名のリスト lockers が指定された場合は、指定されたユーザがロックしたリビジョンに関する情報のみを 表示します。例えば、 rlog -L -R -lwft RCS/* はユーザ wft がロックしている RCS ファイル名を表示します。
- -r[revisions]
- コンマで区切られたリビジョンのリスト revisions で指定されたリビジョンに関する情報のみを表示します。 rev1:rev2 の形式の範囲指定は、同一枝上の rev1 から rev2 までを、 :rev は枝上の最初のリビジョンからリビジョン rev までを、 rev: はリビジョン rev から枝上の最後のリビジョンまでを示します。引数に枝番号を指定した場合は、 その枝上のすべてのリビジョンに関する情報が表示されます。 枝番号による範囲指定は、範囲内の枝上のすべてのリビジョンを示します。 revisions が省略された場合は、デフォルト枝(通常は幹)上の最新リビジョンの情報のみを 表示します。
- -sstates
- 状態が states であるリビジョンの情報のみを表示します。 states はコンマで区切った状態名のリストです。
- -w[logins]
- logins で指定したユーザが登録したリビジョンに関する情報のみを表示します。 logins はコンマで区切ったユーザ名のリストです。 logins が省略された場合は、 rlog を起動したユーザ名が用いられます。
- -T
- このオプションの効果はありません ; ほかの RCS コマンドとの互換性を保つために存在しています。
- -V
- RCS システムのバージョンを表示します。
- -Vn
- ログの生成時に、RCS システムのバージョン n のエミュレーションを行います。詳細は co(1) を参照してください。
- -xsuffixes
- RCS ファイル拡張子を指定します。詳しくは ci(1) を参照してください。
rlog は指定されたオプション -d 、 -l 、 -s 、 -w のすべてに適合し、かつ -b 、 -r の いずれかに適合したリビジョンに関する情報のみを表示します。
- -zzone
- 日時の出力形式を指定し、 -ddates オプションの date に対するデフォルトのタイムゾーンを指定します。 zone には何も指定しないか、数字の UTC を指定するか、ローカルタイムのための 特別な文字列 LT を指定します。 デフォルトは何も指定しない空の zone で、伝統的な UTC の RCS 形式ですが、タイムゾーンを示す表示はなく、 日付の部分を分割するのにスラッシュを用います ; 他では、ISO 形式でタイムゾーンの表示と一緒に時間を出力します。 例えば、ローカルタイムが 太平洋標準時の 1990 年 1 月 11 日、午後 8 時で、 UTC から 8 時間、西である(遅れている)場合、時間の出力は以下のようになります :
option time output -z 1990/01/12 04:00:00 (default) -zLT 1990-01-11 20:00:00-08 -z+05:30 1990-01-12 09:30:00+05:30
使用例¶
rlog -L -R RCS/*
ロックされたすべての RCS ファイル名を出力します。
rlog -L -h RCS/*
ロックされたすべての RCS ファイルのヘッダを出力します。
rlog -L -l RCS/*
ロックされたすべての RCS ファイルのヘッダとログメッセージを出力します。
rlog RCS/*
すべての RCS ファイルに関するすべての情報を出力します。
環境変数¶
診断¶
すべての動作が成功した場合に終了ステータス 0 を返します。
作者¶
Author: Walter F. Tichy.
Manual Page Revision: 1.8; Release Date: 1999/08/27.
Copyright © 1982, 1988, 1989 Walter F. Tichy.
Copyright © 1990, 1991, 1992, 1993, 1994, 1995 Paul Eggert.
関連項目¶
ci(1), co(1), ident(1), rcs(1), rcsdiff(1), rcsintro(1),
rcsmerge(1), rcsfile(5)
Walter F. Tichy, RCS--A System for Version Control, Software--Practice
& Experience 15, 7 (July 1985), 637-654.
バグ¶
以前の版の rlog では -r オプションにおけるリビジョンの区切りは - でした。 しかし、これはシンボリック名が - を含んでいるときに混乱を生じます。 従来の版との互換性のため、 - を用いた記法もサポートしますが、この記法を用いた場合は 警告メッセージを表示します。
1999/08/27 | GNU |